home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 1 / Precision Software Applications Silver Collection Volume One (PSM) (1993).iso / windows / games / weyes20.exe / WEYES2.TXT < prev    next >
Text File  |  1992-06-02  |  14KB  |  287 lines
  1.                    WEYES2.TXT
  2.                    ==========
  3.  
  4. wEyes -- What is it?
  5. --------------------
  6.  
  7.    "wEyes" is a Windows program that, although originally 
  8. designed purely for amusement, might actually be of use to some 
  9. computer users.  Inspired by the famous "xEyes" program run on 
  10. many UNIX-based xWindows systems, this program draws two eyes 
  11. in a window; the eyes then track the movement of the mouse.
  12.  
  13.    I gave the original version of this program (archived 
  14. in "weyes.zip") to a friend of mine who owns a notebook-size 
  15. computer with an LCD screen.  It seems that whenever he ran 
  16. Microsoft Windows, he had problems keeping track of the 
  17. location of his mouse pointer -- LCDs are notoriously slow, and 
  18. if he happened to move the mouse suddenly, he would have to 
  19. scan the entire LCD screen just to locate the pointer.  
  20. wEyes helped.
  21.  
  22.    Since he seemed to benefit, I decided to upload the 
  23. program to Compuserve and some other BBSs, to see if anyone 
  24. else enjoyed it.  To my surprise, that first version was much 
  25. more popular than I ever thought it would be.  Unfortunately, 
  26. though, I had never put the original version through any kind 
  27. of quality-control test.  In short, the program was less than 
  28. flawless.
  29.  
  30.    Enter wEyes v. 1.1.  That version possessed substantial 
  31. enhancements over the original version, including custom 
  32. colorization, elimination of minor bugs, and an all-around 
  33. better interface.  
  34.  
  35.    But a few months after I released version 1.1, 
  36. Microsoft came out with Windows 3.1.  This bittersweet
  37. event had two major ramifications for me.  First, Win 3.1 
  38. revealed a hidden bug in wEyes v. 1.1.  It seemed that, when-
  39. ever the Mission Command dialog box was invoked, some of the 
  40. text within the 3-D area retained a white background, rather 
  41. than the light gray background that I intended.  Second, Win 
  42. 3.1 provided a new capability for its windows:  the so-called
  43. "topmost" feature.  This feature allows a window to be visible
  44. at all times -- even when "covered" by another window.  
  45.  
  46.    So I rewrote wEyes yet again.  This latest version,
  47. version 2.0, fixes the aforementioned bug and takes advantage
  48. of Win 3.1's "topmost" feature.  In addition, users now have
  49. the ability to change the main window's background color.  
  50.  
  51.    Basically, writing the program was a light exercise in 
  52. trigonometry.  The program checks the position of the mouse 
  53. pointer on a regular basis, and using slopes, arctangents, 
  54. sines, and cosines, determines where the "pupils" of the eyes -- 
  55. which are independent of each other -- should be.  
  56.  
  57.  
  58. wEyes 2.0 Enhancements
  59. ----------------------
  60.  
  61.    - "Topmost" capabilities:  When the "wEyes Mission Control" 
  62. dialog box is invoked, one of the controls in the dialog is a
  63. check box labeled "wEyes always on top."  If you are running 
  64. Win 3.1 and you wish to make wEyes visible at all times, click
  65. the mouse on this check box.  If you are running Win 3.0, the
  66. check box will be disabled and will appear grayed.
  67.  
  68.    - Background color:  Now, in addition to adjusting the color 
  69. of wEyes's pupils and outer rims, you can adjust the background
  70. color as well.  (Neophytes:  see "wEyes 1.1 Enhancements - 
  71. Colors" below for more information.)
  72.  
  73.    - Bugs:  Hard to believe, but wEyes 1.1 had a hidden bug 
  74. that was not visible in Win 3.0.  Some of the text in the
  75. "Mission Control" dialog box appeared on a white background,
  76. rather than on a light gray one.  Hence, these little text 
  77. items stuck out like the proverbial irritated digits.  The 
  78. problem has been rectified in wEyes v. 2.0.
  79.  
  80.    - Odds & ends:  I don't know if anyone will notice, but I
  81. made some slight changes to the algorithm used in updating
  82. the positions of wEyes's pupils.  It should make pupil movement
  83. a little faster -- though perhaps the difference is imper-
  84. ceptible.
  85.  
  86.  
  87. wEyes 1.1 Enhancements
  88. ----------------------
  89.  
  90.    - Interface:  As of v. 1.1, wEyes sports two dialog boxes.  
  91. The first is the traditional "About" dialog box, which displays 
  92. version and other basic information.  The second is the "wEyes 
  93. Mission Control" dialog box, explained in more detail below.  
  94. This dialog box gives the user control over colors and "pupil 
  95. update rates." In addition to being functional, these dialog 
  96. boxes have a rather slick three-dimensional look.  No, I'm not 
  97. bragging -- the 3-D effect is due in large part to a dynamic-
  98. link library that I've incorporated into the program.  The file 
  99. is "three_d.dll," and it was written by a guy named Ray Donahue.  
  100. (If you are a programmer and like the look and feel of wEyes's 
  101. dialog boxes, you have my recommendation to license Donahue's 
  102. libraries.  They are flexible and incredibly easy to implement.  
  103. Ray can be reached at the following address:  Ray Donahue, 
  104. 365 Mather Street Unit 125, Hamden, CT 06514; or on Compuserve: 
  105. 70324,1204.  I downloaded the DLL from the WINADV forum, 
  106. on Compuserve.)  The only hitch here is that wEyes will only 
  107. support VGA monitors -- as for other monitors, I cannot 
  108. guarantee compatibility.
  109.  
  110.    - Colors:  wEyes now allows the user to define which 
  111. colors he or she wants for the "rims" and "pupils" of the 
  112. window's eyes.  To define customized colors, activate the 
  113. "Mission Control" dialog box.  This is accomplished by clicking 
  114. wEyes's control box (the little box in the top left-hand corner 
  115. of the window).  The control menu will appear.  At the very 
  116. bottom, you will notice two items: "About wEyes..." and "wEyes 
  117. Mission Control...."  Click once on "Mission Control."  The 
  118. Mission Control dialog box will appear.   
  119.    Next, find the two group boxes named "Outer rim color" 
  120. and "Pupil color," respectively.  Each box contains three 
  121. horizontal scrollbars.  Each scrollbar controls the intensity of 
  122. either the red, green, or blue color elements of your screen.  
  123. Move the scrollbars, and the color appearing in the window beside 
  124. the controls will change to reflect your handiwork.  When 
  125. satisfied, press the "OK" button.  If you just can't get it right, 
  126. that's alright -- just press the Cancel button and your wEyes will 
  127. not have changed.
  128.    Some of you probably own a notebook or laptop with a 
  129. monochrome LCD screen.  This does NOT mean that you can't take 
  130. advantage of the coloring capabilities included in this version.  
  131. As you probably know, different people prefer different 
  132. intensity settings when using LCD screens:  some prefer that 
  133. the screen look darker, while others can only work with a 
  134. lighter-shaded screen.  To the extent that your tastes differ 
  135. from the next guy's, the red-and-black default colors may be 
  136. difficult to see on your LCD screen.  If so, the Mission 
  137. Control color features can help.
  138.  
  139.    - Timer interval:  wEyes checks the position of the 
  140. mouse pointer at a predetermined time interval, and then 
  141. readjusts the position of the pupils accordingly.  In the 
  142. original version of wEyes, this "pupil update rate" was 100 
  143. milliseconds by default.  That parameter could be changed, 
  144. however, by including a command-line parameter.  The Mission 
  145. Control dialog box has eliminated the need for such a mechanism.  
  146. The interval can now be adjusted in much the same way as the 
  147. colors of the eyes.  When the scrollbar in the "Timer interval" 
  148. group box is adjusted, the number appearing in the edit box 
  149. to the right of the scrollbar will be similarly adjusted.  If 
  150. you want to enter a particular number in the edit box, however, 
  151. you need not use the scrollbar -- just click your mouse on the 
  152. edit box (or "tab over"), and type in the desired number.
  153.    If you are running a number of large applications 
  154. concurrently, you may want to slow the timer down a bit, so as 
  155. not to burden the other programs.  On the other hand, unless 
  156. you have a very fast machine, intervals of less than 50 
  157. milliseconds will probably not produce any additional speed 
  158. benefits; there will always be some lower limit for a given 
  159. machine.
  160.  
  161.    - Initialization file:  The first time that you close 
  162. wEyes (or end a Windows session without closing wEyes first), 
  163. the program will create an initialization file in your WINDOWS 
  164. directory.  The file is called, appropriately enough, 
  165. "weyes.ini."  The next time that you run wEyes, the program 
  166. will "remember" the colors that you last specified, and will 
  167. automatically use them in your current session.  In addition, 
  168. unlike the original version, wEyes will store the window's 
  169. size and position.  So rather than having to move and stretch 
  170. the window every time you start wEyes, the window will 
  171. automatically pop up exactly where you want it.  
  172.  
  173.    - Minimization:  As with the original version of wEyes, 
  174. wEyes v. 1.1 still works when minimized.  So if you need room 
  175. on your display, wEyes won't take up any more room than, say, 
  176. the Windows Clock program. 
  177.  
  178.    - Bugs:  Fallible?  Me?  I encountered one minor, 
  179. although annoying, bug in the original version of wEyes.  It 
  180. seems that, if I stretched the window far enough across the 
  181. screen, I would get an unrecoverable application error.  That 
  182. problem has since been put to bed.
  183.    Also, the original version had no mechanism for 
  184. aborting the program in the unlikely event that a timer could 
  185. not be created.  Should Windows already have the maximum number 
  186. of timers running, wEyes v. 1.1 will not run, but will display 
  187. a message informing the user of the problem. This version 
  188. appears to work pretty well.  Nonetheless, because I'm not 
  189. charging money for this program, it's difficult to justify 
  190. putting hours and hours into crash-testing the thing.  Thus, 
  191. I'm relying on user input.  If you find any bugs in this 
  192. version of wEyes, please drop me a line at the address below.  
  193. Or you can send me e-mail at Compuserve.  My address there is 
  194. 70724,3347 (InterNet: "70724.3347@compuserve.com").
  195.  
  196. ================================================================
  197.  
  198.                         DISCLAIMER
  199.  
  200.    No copyright is claimed in "weyes.exe," "weyes.ini," 
  201. "weyes2.doc," "weyes2.wri," or "weyes2.txt" (collectively, 
  202. the "Software") by its author, Rob Carty ("Author").  No rights 
  203. related to the Software are granted by Author.  The user agrees 
  204. to use the Software at his or her own risk, and agrees not to 
  205. hold Author liable for any damages, direct, indirect, 
  206. consequential, incidental or otherwise, in tort, in contract, 
  207. or upon any other theory of law or equity, regardless of whether 
  208. such damages are caused by Author's own negligence or gross 
  209. negligence.
  210.  
  211.    The file named "three_d.dll" is copyrighted intellectual 
  212. property, distributed under license.  The user, however, need 
  213. not pay royalties for copying or using that file in conjunction 
  214. with the Software, pursuant to the license granted Author.
  215.  
  216. ================================================================
  217.  
  218. Loading instructions:
  219. ---------------------
  220.  
  221.    To load wEyes onto your Windows system, first copy 
  222. "weyes.exe," "weyes.txt," and "three_d.dll" to the directory of 
  223. your choice.  Next, enter Windows's Program Manager and select 
  224. a program group.  Then select "File," "New," "Program Item" 
  225. from the menu bar (in that order).  In the "Command Line" edit 
  226. box, type: "<Drive>:\<Pathname>\WEYES.EXE", where <Drive> and 
  227. <Pathname> are the drive and directory into which you have 
  228. installed the above program files.  Choose "OK."  When you want 
  229. to invoke the program, simply double-click the wEyes icon.  
  230.    To auto-load the program upon starting a Windows 
  231. session, do the following: 
  232.  
  233.    Win 3.1
  234.  
  235.    -------
  236.       Install wEyes in the "Startup" program group.  To run the 
  237.    program as an icon, check the "Run Minimized" check box.
  238.  
  239.    Win 3.0
  240.    -------
  241.  
  242.       Open your "win.ini" file (located in your WINDOWS 
  243.    directory) by using the Windows Notepad program.  Find the 
  244.    line labeled "[windows]"; then look for the "load=" 
  245.    statement.  Beside that statement, type 
  246.    "<Drive>:\<Pathname>\WEYES.EXE", again where <Drive> and 
  247.    <Pathname> are the drive and directory into which you have 
  248.    installed the program files.  The next time that you invoke 
  249.    windows, wEyes will appear as a minimized window at the 
  250.    bottom of your screen.  To run wEyes as a regular (non-
  251.    minimized) window, perform these same steps, except rather 
  252.    than looking for the "load=" statement, look for the "run=" 
  253.    statement.
  254.  
  255. ================================================================
  256.  
  257. This program is written mostly for fun.  If you do enjoy it and 
  258. would like to find out about other products and services 
  259. provided by OutLook/PC Business System Design, drop us a line 
  260. at:
  261.  
  262.       OutLook/PC Business System Design
  263.       ATTN: M. Bradley, MSSI
  264.       P.O. Box 684255          
  265.       Austin, TX  78768-4255
  266.  
  267.       Compuserve:  70724,3347
  268.  
  269. We usually specialize in more serious undertakings, 
  270. specifically management information systems.  Even more 
  271. specifically, we are seeking out small- to mid-sized law firms
  272. in South and Central Texas that require information systems
  273. and solutions (I have a J. D. -- University of Texas School of 
  274. Law, Class of 1991).  If you fit the above description (or if 
  275. you know anyone who does), please let us know.  We specialize 
  276. in building open, flexible information systems, and we can do 
  277. it quickly and cheaply.  And when we're done, our clients do 
  278. not become our slaves.
  279.  
  280. Thanks.
  281.  
  282. -- Rob Carty, President
  283.    2 June 1992
  284.  
  285.       
  286.   
  287.